fragment-cache

What is fragment-cache?

The fragment-cache package is a simple caching module that allows you to set and get fragments of data. It is particularly useful for storing parts of data that are expensive to generate, such as parts of web pages or results of complex calculations, so that they can be reused without needing to be recalculated.

What are fragment-cache's main functionalities?

Setting and getting cache entries

This feature allows you to store a value in the cache under a specific key and then retrieve that value using the key. It's useful for caching results of operations that are expensive to compute.

const FragmentCache = require('fragment-cache');
const cache = new FragmentCache();
cache.set('key', 'value');
const value = cache.get('key');

Checking if a cache key exists

This feature enables you to check if a specific key exists in the cache. It can be used to determine whether you need to generate a new value for the cache or if you can reuse an existing value.

const FragmentCache = require('fragment-cache');
const cache = new FragmentCache();
cache.set('key', 'value');
const exists = cache.has('key');

Other packages similar to fragment-cache

memory-cache

Similar to fragment-cache, memory-cache provides in-memory caching capabilities. It allows for storing and retrieving data in a simple key-value format. The main difference is in the API and additional features like time-based expiration of cache items.

node-cache

node-cache is another in-memory caching solution with a feature set that includes TTL (time to live) for cache entries, stats about the cache state, and keys manipulation. It offers more advanced features compared to fragment-cache, making it suitable for more complex caching needs.

README

fragment-cache

A cache for managing namespaced sub-caches

Install

Install with npm:

$ npm install fragment-cache --save

Usage

var Fragment = require('fragment-cache');
var fragment = new Fragment();

API

FragmentCache

Create a new FragmentCache with an optional object to use for caches.

Params

• cacheName {String}
• returns {Object}: Returns the map-cache instance.

Example

var fragment = new FragmentCache();

.cache

Get cache name from the fragment.caches object. Creates a new MapCache if it doesn't already exist.

Params

• cacheName {String}
• returns {Object}: Returns the map-cache instance.

Example

var cache = fragment.cache('files');
console.log(fragment.caches.hasOwnProperty('files'));
//=> true

.set

Set a value for property key on cache name

Params

• name {String}
• key {String}: Property name to set
• val {any}: The value of key
• returns {Object}: The cache instance for chaining

Example

fragment.set('files', 'somefile.js', new File({path: 'somefile.js'}));

.has

Returns true if a non-undefined value is set for key on fragment cache name.

Params

• name {String}: Cache name
• key {String}: Optionally specify a property to check for on cache name
• returns {Boolean}

Example

var cache = fragment.cache('files');
cache.set('somefile.js');

console.log(cache.has('somefile.js'));
//=> true

console.log(cache.has('some-other-file.js'));
//=> false

.get

Get name, or if specified, the value of key. Invokes the cache method, so that cache name will be created it doesn't already exist. If key is not passed, the entire cache (name) is returned.

Params

• name {String}
• returns {Object}: Returns cache name, or the value of key if specified

Example

var Vinyl = require('vinyl');
var cache = fragment.cache('files');
cache.set('somefile.js', new Vinyl({path: 'somefile.js'}));
console.log(cache.get('somefile.js'));
//=> <File "somefile.js">

Related projects

You might also be interested in these projects:

• base: base is the foundation for creating modular, unit testable and highly pluggable node.js applications, starting… more | homepage
• map-cache: Basic cache object for storing key-value pairs. | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.

---

This file was generated by verb, v0.9.0, on May 02, 2016.